/*
    ## Helpers
*/

var Util = require('../util')

module.exports = {
  // 把字符串的第一个字母转换为大写。
  capitalize: function (word) {
    return (word + '').charAt(0).toUpperCase() + (word + '').substr(1)
  },
  // 把字符串转换为大写。
  upper: function (str) {
    return (str + '').toUpperCase()
  },
  // 把字符串转换为小写。
  lower: function (str) {
    return (str + '').toLowerCase()
  },
  // 从数组中随机选取一个元素，并返回。
  pick: function pick (arr, min, max) {
    // pick( item1, item2 ... )
    if (!Util.isArray(arr)) {
      arr = [].slice.call(arguments)
      min = 1
      max = 1
    } else {
      // pick( [ item1, item2 ... ] )
      if (min === undefined) min = 1

      // pick( [ item1, item2 ... ], count )
      if (max === undefined) max = min
    }

    if (min === 1 && max === 1) return arr[this.natural(0, arr.length - 1)]

    // pick( [ item1, item2 ... ], min, max )
    return this.shuffle(arr, min, max)

    // 通过参数个数判断方法签名，扩展性太差！#90
    // switch (arguments.length) {
    // 	case 1:
    // 		// pick( [ item1, item2 ... ] )
    // 		return arr[this.natural(0, arr.length - 1)]
    // 	case 2:
    // 		// pick( [ item1, item2 ... ], count )
    // 		max = min
    // 			/* falls through */
    // 	case 3:
    // 		// pick( [ item1, item2 ... ], min, max )
    // 		return this.shuffle(arr, min, max)
    // }
  },
  /*
	    打乱数组中元素的顺序，并返回。
	    Given an array, scramble the order and return it.

	    其他的实现思路：
	        // https://code.google.com/p/jslibs/wiki/JavascriptTips
	        result = result.sort(function() {
	            return Math.random() - 0.5
	        })
	*/
  shuffle: function shuffle (arr, min, max) {
    arr = arr || []
    var old = arr.slice(0)

    var result = []

    var index = 0

    var length = old.length
    for (var i = 0; i < length; i++) {
      index = this.natural(0, old.length - 1)
      result.push(old[index])
      old.splice(index, 1)
    }
    switch (arguments.length) {
      case 0:
      case 1:
        return result
      case 2:
        max = min
        /* falls through */
      case 3:
        min = parseInt(min, 10)
        max = parseInt(max, 10)
        return result.slice(0, this.natural(min, max))
    }
  },
  /*
	    * Random.order(item, item)
	    * Random.order([item, item ...])

	    顺序获取数组中的元素

	    [JSON导入数组支持数组数据录入](https://github.com/thx/RAP/issues/22)

	    不支持单独调用！
	*/
  order: function order (array) {
    order.cache = order.cache || {}

    if (arguments.length > 1) array = [].slice.call(arguments, 0)

    // options.context.path/templatePath
    var options = order.options
    var templatePath = options.context.templatePath.join('.')

    var cache = (
      order.cache[templatePath] = order.cache[templatePath] || {
        index: 0,
        array: array
      }
    )

    return cache.array[cache.index++ % cache.array.length]
  }
}
